home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / oevent4d.arc / OEVENT.DOC next >
Text File  |  1988-02-25  |  13KB  |  283 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                               OPUS <non-TM>  EVENT muncher
  9.                                         Version 4d
  10.                                      February 25, 1988
  11.  
  12.  
  13.       One of  the things  about the  continued growth of OPUS is that it con-
  14.       stantly needs new utilities to maintain it. Hopefully this program will
  15.       fill one  of the needs for the people who are using OPUS 1.00  with its
  16.       extended scheduling commands.        
  17.           
  18.       OEVENT should be fairly simple to use, just type in:
  19.            
  20.                 OEVENT [FILENAME.EXT] [-C] [-L  [> PRN:] [>FILE.EXT] ]
  21.            
  22.       If no file is specified OEVENT will look for SCHED.BBS. 
  23.  
  24.       The '-C' option will Create a new schedule file for  OPUS with  one ex-
  25.       ternal  event  at  midnight,  for  one minute, and keep the schedule in
  26.       memory for editting. You do need one external event with OPUS each day.
  27.       Just "OEVENT -C" will create SCHED.BBS, ready to edit.
  28.  
  29.       The '-L'  option will  List the  events in the file specified, or if no
  30.       file is specified, in SCHED.BBS.
  31.            
  32.          The screen will look like this:  
  33.  
  34.    ------------------------------------------------------------------
  35.  
  36. Event Tag       Day   Start  End   Run?      Exit  Mail  LO  CM  SX  MO  FR 
  37.                                                    <5>   <6> <7> <8> <9> <9>
  38.  
  39.    0   Y        ALL   9:00  22:00  ENA       5
  40.    1 * X        ALL   1:01   1:02  ENA  F   30
  41.    2   X        ALL   3:30   3:35  ENA  F   50
  42.    3   Z        ALL   1:10   2:00  ENA              Y    N   Y   Y   Y   N
  43.    4   Z        ALL   3:35   7:59  ENA              Y    N   Y   N   N   Y
  44.    5   X        ALL   7:59   8:00  ENA  F   59
  45.    6   Z        ALL   8:00  23:01  ENA              Y    Y   N   N   N   Y
  46.    7   X        ALL   5:30   5:30  DIS  F   60
  47.    8   Z        ALL  23:01  24:00  ENA              Y    N   Y   N   N   Y
  48.  
  49.    <-> Previous Event    <+> Next Event      <Q> Quit          <H> Home
  50.    <S> Start Time        <E> End Time        <F> Forced Event  <I> Insert
  51.    <R> Error Level       <D> Day-of-week     <T> Event Tag     <O> Sort
  52.    <*> Edit Everything   <Z> Edit Behavior   <G> Use GMT       <L> Flush/Edit
  53.    <1> Enable Event      <2> Disable Event   <3> Delete Event  <N> Jump to N
  54.  
  55.      By your command? 
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.          The Commands:
  64.          --- ---------
  65.  
  66.       Most commands can be reached two or three ways. This  is primarily to
  67.       make sure that OEVENT will run on anything that OPUS will run on, but
  68.       also means that you can pick any command set that you are comfortable
  69.       with.
  70.  
  71.       "-", "_", Move Up            Move  to  lower-number  event, up on the
  72.                                    screen. (Up Arrow on IBM and compatibles
  73.                                    will also work)
  74.  
  75.       "+", "="   Move Down         Move to higher-number event, down on the
  76.                                    screen. (Down Arrow  will  also  work on
  77.                                    IBM and close compatibles)
  78.  
  79.       "<", ",", PgUp   Page Up     Moves up 8 Events, one screen full.
  80.  
  81.       ">", ".", PgDn   Page Down   Move down 8 Events, one screen full.
  82.  
  83.       H, Home                      Move to Event #0.
  84.  
  85.       Q        Quit,               Save the changes and exit.
  86.  
  87.       ESC      Abort               Abort this  run. Do  NOT save any of the
  88.                                    changes.
  89.  
  90.       S        Start Time          Set the time that this event will start 
  91.                                    in Hour:Min, 24-hour format.
  92.  
  93.       E        End Time            Set the End of this event in Hour:Minute
  94.                                    format.  Must  be  equal to or less than
  95.                                    Start Time,  OPUS  will  _NOT_  carry an
  96.                                    event past midnight. 0 Length events are
  97.                                    possible by setting Start  and End Times
  98.                                    to  the  same  value.  (Handy for forced
  99.                                    External Events)
  100.  
  101.       F        Forced Event        Make this a Forced Event. OPUS  will run
  102.                                    this event  as soon as possible if some-
  103.                                    thing  creates  a  situation  where  the
  104.                                    event is missed. (i.e. A user does a big
  105.                                    upload just before the  event, mail pac-
  106.                                    ket is being transferred, etc.)
  107.  
  108.       I        Insert              Insert an  event here. Will move all the
  109.                                    events below it down and will DELETE the
  110.                                    final event! Use with care if! 
  111.  
  112.       R        Error Level         Set the  Error Level for External Events
  113.                                    or the length of time the bell will ring
  114.                                    for Y)ell event.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.       D        Day-of-Week         Set  the  Day  of  Week  that this event
  122.                                    runs. (0=Sunday, 1=Monday, ... 7=All)
  123.  
  124.       T        Event Tag           Change the Event Tag. 
  125.  
  126.                                    A-W = External event with Errorlevel set
  127.                                    to decimal value of uppercase letter.
  128.  
  129.                                    X =  External Event, Errorlevel set by R
  130.                                    command above. YOU  MUST  HAVE  AT LEAST
  131.                                    ONE EXTERNAL EVENT EVERY DAY FOR OPUS!
  132.  
  133.                                    Y =  Yell Event.  When do you want users
  134.                                    to be able to get your attention. Should
  135.                                    always be Event #0.
  136.  
  137.                                    Z  =  Behavior  Event.  Controls the way
  138.                                    OPUS will  handle  mail,  do  Scans, and
  139.                                    take care of the Outbound directory.
  140.  
  141.       O        Sort Events         Sorts events  by Start Time. Should help
  142.                                    you  keep  straight  what  is  going on.
  143.                                    Automatically packs  events (gets rid of
  144.                                    the Deleted Events  mixed  in  with Dis-
  145.                                    abled and Enabled Events). Does NOT sort
  146.                                    Event 0 (the Y)ell event) or the Deleted
  147.                                    Events.
  148.  
  149.       *        Edit Everything     Go  through  all  the  commands  for an-
  150.                                    event, automatically sets  Event  as En-
  151.                                    abled.
  152.  
  153.       Z        Edit Behavior       Modify the way OPUS will handle outbound
  154.                                    mail. Will  give  you  a  new  Menu with
  155.                                    specific commands. 
  156.  
  157.                You can  also alter  the way  OPUS will handle outbound mail
  158.                during this event from the main menu, shown  above, by using
  159.                the numeric  (or Function Keys on IBM compatibles) as listed
  160.                here:
  161.  
  162.                5, F1          Toggle Send Mail during this event.
  163.                6, F2          Toggle Local Mail Only, for those boards that
  164.                               are a no-charge call.
  165.                7, F3          Toggle  Continuous-Mail  only. Send only mail
  166.                               marked as "Crash" to  another board  that can
  167.                               accept mail 24 hours.
  168.                8, F4          Toggle Suppress  Exits. If Yes, OPUS will NOT
  169.                               Exit when Crash-Mail  or  other  reasons con-
  170.                               trolled by CTL file.
  171.                9, F5          Toggle  Mail-Only.  If  Yes,  will not accept
  172.                               human callers.
  173.                0, F6          Toggle File-Requests.  If  Yes, File-Requests
  174.                               will be honored. If No, will refuse them.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.       G        GMT       Toggle using Greenwich Mean Time for this Event.
  183.  
  184.       P        Pack      Gets rid  of Deleted  Events in the middle of your
  185.                          schedule.  Moves  them  down  and  pushes  all the
  186.                          Enabled and Disabled Events up.
  187.  
  188.       N        Jump N    Jump to even N.
  189.  
  190.       1        Enable    Turn this Event on.
  191.  
  192.       2        Disable   Turn this Event off, but retain the information.
  193.  
  194.       3        Delete    Turn  this  Event  off, and/or delete the informa-
  195.                          tion. Primary use is  that it  cleans up  the dis-
  196.                          play.
  197.  
  198.       L        Flush     Flush what's  been done to disk and continue edit-
  199.                          ing.
  200.  
  201.       V        Done?     Toggles the event flag that stores  whether or not
  202.                          an event has been completed. If the event has been
  203.                          done, there will be an asterisk '*' on  that line,
  204.                          if there  is no asterisk, the event is still wait-
  205.                          ing to be done or doesn't run today.
  206.  
  207.       The event that OEVENT will operate on will  be in  inverse video. You
  208.       can use either the cursor keys or the '+' and '-' keys to move up and
  209.       down through  the  events.  OEVENT also  know about  PgUp, PgDn   and
  210.       Home for quicker movement around the events. 
  211.            
  212.       When you  get to  an event  you wish to change you can choose the ap-
  213.       propriate commands. For example '1', '2' or '3' changes an event from
  214.       Enabled to Disabled to Deleted, or if you wish to change the behavior
  215.       of OPUS as far as handling mail in an event that is  already   set to
  216.       handle mail  just use the 'Z' command. 'E' will edit everything about
  217.       an event except for its enabled status.
  218.                 
  219.       OEVENT is all menu-driven. I could never remember  all the  things  I
  220.       wanted to change in one pass, and OPUS crams so much more information
  221.       into SCHED.BBS that it just isn't feasible to  alter events  from the
  222.       command line.
  223.            
  224.       One subtle  advantage is  that OEVENT  does allow zero-length events.
  225.       That can be extremely helpful for doing special  things like changing
  226.       outbound message  packets from Hold to Crash with OMMM.EXE. OPUS will
  227.       allow them and will honor them, but the  internal Event  editor won't
  228.       allow zero length events, at least as of XX9X. 
  229.            
  230.          Please forward any comments/suggestions/bug-reports to:
  231.  
  232.                                       Doug Boone
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.                                       119/5
  240.  
  241.  
  242.  
  243.  
  244.      
  245.  
  246.     August 10, 1987: (Oevent 4a)
  247.       
  248.     Added the  ESC command to allow you to exit without saving any changes.
  249.     ^C should also have the same effect. OEVENT  opens the  SCHED.BBS file,
  250.     it reads the SCHED.BBS file, and it closes the SCHED.BBS file before it
  251.     does anything else. This should be failsafe because what you  are doing
  252.     in memory does not affect what is stored on the disk until you Q)uit. 
  253.       
  254.     Also  worked  on  the  problem  of OEVENT getting upset with people who
  255.     accidently hit  letters when  entering time  values by  reading in each
  256.     character as  it is  typed and  checking it.   Moved the display of the
  257.     time to where you'd expect it to be while its being typed in.   One odd
  258.     effect of this change is the way partial times are entered, for example
  259.     if you enter, "1:1", OEVENT will assume you  are trying  to enter 1:01,
  260.     and not 1:10.  
  261.       
  262.     Hitting a carriage return in answer to a question should not scroll the
  263.     screen up any more. It is a valid response for  the Start  and End time
  264.     commands, telling OEVENT that you don't what to change that event after
  265.     all. Most other commands will now just ignore invalid responses. 
  266.  
  267.     August 22, 1987: (Oevent 4b)
  268.  
  269.     Fixed errors induced in OEVENT4A dealing with End of events.
  270.  
  271.     August 29, 1987: (Oevent 4c)
  272.  
  273.     Added the 'N' command  to jump  to a  certain event,  flag handling for
  274.     SCAN ALL event (Not installed in OPUS yet!), and  fixed Behavior Menu.
  275.  
  276.     February 11, 1988: (Oevent 4d)
  277.  
  278.     Removed the  Scan All,  Opus 1.0X will never have a Scan event and Opus
  279.     1.1X will use a different event  structure.  Added  <L>  Flush  to disk
  280.     command, the  <V> done flag, and cleaned up the menus and display some-
  281.     what. 
  282.  
  283.